home *** CD-ROM | disk | FTP | other *** search
/ Aminet 19 / Aminet 19 (1997)(GTI - Schatztruhe)[!][Jun 1997].iso / Aminet / comm / maxs / dfbv13.lha / dfb / Utilities / DFB_UserStats / DFB_UserStats.Doc < prev    next >
Text File  |  2005-02-23  |  7KB  |  186 lines
  1.  
  2.                              DFB_UserStats 0.1
  3.  
  4.                                     by
  5.  
  6.                              Prowler / Cydonia
  7.  
  8.                            Released 11-Feb-1996
  9.  
  10. DESCRIPTION.
  11.  
  12.  DFB_UserStats is a small door that is to be used with DFB [Dynamic File
  13.  Base] by Andrew Leppard and MAXs BBS by Anthony Barret.
  14.  
  15.  There is nothing fantastic or 'gee-wiz' about this door, in fact it is
  16.  quite a boring door when you think about it. Its funtion in life is to let
  17.  your users list their personal DFB related data, such as their ratio,
  18.  uploads/downlaods etc.
  19.  
  20.  About the only saving graces for the use of this door that I can think of 
  21.  are:
  22.  
  23.  1) It lets you use MAXs auto-inserts meaning your user can have all there 
  24.     information on the one screen.
  25.  
  26.  2) The only other way for the user to find there information is to 
  27.     actually go to the file base, still, how are they to find out how many 
  28.     days left they have before their paid membership runs out ??
  29.  
  30.  This door lets you do the above, and if there is something you don't want, 
  31.  it lets you leave it out! 
  32.  
  33.  With all the above boring drivel over and done with, lets go and set the 
  34.  door up. Ops, one last thing, the disclaimer.
  35.  
  36. DISCLAIMER.
  37.  
  38.  The author of this programme takes no responsibility for any damage that 
  39.  may occur whilst using this programme, be it physical/mental etc.
  40.  
  41.  This programme is entered into the public domain as is! And the executable
  42.  may not be modified in anyway, whatsoever.
  43.  
  44.  All rights belong to me, as the programmer of this programme.
  45.  
  46.  (Did that sound profound enough to you ?? To bad if it didn't, also if my 
  47.   bad gramar and spelling annoys you, tough. I am typing these docs out and 
  48.   not worrying about them. It's not much of a door anyway).
  49.  
  50. REQUIRMENTS.
  51.  
  52.  You need to be using MAXs BBS and DFB as your file handler to be able to 
  53.  use this piece of crap.
  54.  
  55.  DFB_UserStats should work on MAXs BBS 1.52+ and since DFB requires 
  56.  Workbench 2.xx+, I would hazard a gues that it requires that as well.
  57.  
  58.  This programme works without too many problems on both my A1200/030 and 
  59.  A2000/020. if you have any problems with the programme, I would, nah, want 
  60.  to know about them!
  61.  
  62. INSTALLATION.
  63.  
  64.  There is nothing complex with installing this door, and if you have any 
  65.  troubles with this part, you should not be running a BBS!
  66.  
  67.  Besides this Doc, you should also have the following files:
  68.  
  69.  - DFB_UserStats
  70.  - DFB_UserStats.text
  71.  - DFB_UserStats.config
  72.  
  73.  They all need to be in the same directory! It doesn't matter what 
  74.  directory you place them in, they don;t care, they are happy as long as
  75.  they are together!
  76.  
  77.  To run this door, just use the normal MAXs execute door function. The 
  78.  actual door is DFB_UserStats.
  79.  
  80. CONFIGURATION.
  81.  
  82.  Ahh, variety is the spice of life. Now this is the only tricky bit in the 
  83.  entire doc. [That's if you don't count falling asleep while reading it 
  84.  that is].
  85.  
  86.  After saying that, you shouldn;t have any troubles as long as you follow 
  87.  what I say. Would I lie to you ??
  88.  
  89.  You can create your own text file to be displayed, fab huh ? Why would you 
  90.  want to do this ?? Why, so it matches the rest of your BBS Decour. 
  91.  
  92.  So, you have knocked up your text to be displayed, you can use MAXs auto
  93.  inserts [I hope so anyway]. Now what you need to do, is grab your 
  94.  horizontal and vertical coordinates for where you wish the different 
  95.  information to be positioned. The text file menu thingo you have should be
  96.  a replacement for the DFB_UserStats.text file that came with the archive.
  97.  
  98.  Line          What it is
  99.  
  100.    1           Type of ratio system your BBS is using.
  101.    2           Users DFB number.
  102.    3           Total users on your System.
  103.    4           Users current access level.
  104.    5           Users daily time limit.
  105.    6           Days left for users membership to run out.
  106.    7           Users ratio for section 1
  107.    8           Users ratio for section 2
  108.    9           Users ratio for section 3
  109.   10           Users Downloads for section 1
  110.   11           Users Downloads for section 2
  111.   12           Users Downloads for section 3
  112.   13           Users uploads for section 1
  113.   14           Users uploads for section 2
  114.   15           Users uploads for section 3
  115.   16           Pause prompt position.
  116.  
  117.  All the above should be self explanatory. And is what each line in your 
  118.  DFB_UserStats.config is for.
  119.  
  120.  I will just let you know that if the users membership days left = 0 [never 
  121.  runs out] it will print 'Never' instead of 0. Also the pause position is 
  122.  where the door will place the 'Hit any key to continue' prompt.
  123.  
  124.  Here's the example config that is included in the archive:
  125.  
  126. 0955
  127. 1535
  128. 1560
  129. 1143
  130. 1335
  131. 1758
  132. 1923
  133.  
  134.  
  135. 2155
  136.  
  137.  
  138. 2124
  139.  
  140.  
  141. 2501
  142.  
  143.  Here is how it works in detail. The first two numbers are the horizontal 
  144.  (line number) you want the selected informaion on, and the second two are
  145.  for the vertical (row number). They _MUST ALWAYS_ be 4 digits! So as you  
  146.  see above, if it is on line 9, you must enter a line number of 09 etc.
  147.  
  148.  If you do not want a particular thing printer out, leave a line feed in 
  149.  its place, make sure there are no spaces in front of it!
  150.  
  151.  That's all there is to it! Have a play and see what you can destroy ;)
  152.  
  153. FUTURE/NOTES.
  154.  
  155.  I most likely will never add anything extra to this door, only if I am 
  156.  bored. if I did, it would most likely be something wanky like let the user
  157.  list what files he has uploaded or edit his sent by line etc.
  158.  
  159.  This is the first door I have ever written, heck it is the first programme 
  160.  of any kind I have ever written :) And was proudly done in _ASSEMBLER_ 
  161.  Cool huh ? even though the code is most likely pretty shocking :)
  162.  
  163.  Any bug reports or ideas for other doors are more than appreciated! I
  164.  already have a few more ideas, and i am currently in the middle of a
  165.  Remote User Editor for DFB.
  166.  
  167.  You can get in direct contact with me by calling my BBS:
  168.  
  169.  Twisted Dreams BBS     (02) 6364990    +61-2-6364990   - 33.6k
  170.  
  171.  Or any BBS that carrier CydoniaNET.
  172.  
  173.  Future Dimensions      (075) 5297457   +61-755-297457  - 28.8k
  174.  
  175.  Lucid Dreams           (02) 8889917    +61-2-8889917   - 14.4k
  176.  
  177.  Planet X               (02) 8322776    +61-2-8322776   - 28.8k
  178.  
  179.  Syndicate              (08) 3713553    +61-8-3713553   - 33.6k
  180.                         (08) 2937467    +61-8-2937476   - 14.4k
  181.  
  182.  Special thanks to Zenith/Frontier and Accolyte/Cydonia for there help.
  183.  
  184.  Also greets to _ALL_ the demo groups in Australia. And to my swappers.
  185.  
  186.  I must also apologize to Cydonia for releasing this door ;).